<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->
<title>grantpt</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_000_005_866">&nbsp;</a>NAME</h4><blockquote>
grantpt - grant access to the slave pseudo-terminal device
</blockquote><h4><a name = "tag_000_005_867">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

#include &lt;<a href="stdlib.h.html">stdlib.h</a>&gt;

int grantpt(int <i>fildes</i>);
</code>
</pre>
</blockquote><h4><a name = "tag_000_005_868">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>grantpt()</i>
function changes the mode and ownership of the slave pseudo-terminal device
associated with its master pseudo-terminal counter part.  The <i>fildes</i>
argument is a file descriptor that refers to a master pseudo-terminal device.
The user ID of the slave is set to the real UID of the calling process and the
group ID is set to an unspecified group ID.  The permission mode
of the slave pseudo-terminal is set to readable and writable by the owner,
and writable by the group.
<p>
The behaviour of the
<i>grantpt()</i>
function is unspecified if the application has installed a signal handler
to catch SIGCHLD signals
</blockquote><h4><a name = "tag_000_005_869">&nbsp;</a>RETURN VALUE</h4><blockquote>
Upon successful completion,
<i>grantpt()</i>
returns 0.  Otherwise, it returns -1 and sets
<i>errno</i>
to indicate the error.
</blockquote><h4><a name = "tag_000_005_870">&nbsp;</a>ERRORS</h4><blockquote>
The
<i>grantpt()</i>
function may fail if:
<dl compact>

<dt>[EBADF]<dd>
The <i>fildes</i> argument is not a valid open file descriptor.

<dt>[EINVAL]<dd>
The <i>fildes</i> argument is not associated with a master pseudo-terminal
device.

<dt>[EACCES]<dd>
The corresponding slave pseudo-terminal device could not be accessed.

</dl>
</blockquote><h4><a name = "tag_000_005_871">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_005_872">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_005_873">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_005_874">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="open.html">open()</a></i>,
<i><a href="ptsname.html">ptsname()</a></i>,
<i><a href="unlockpt.html">unlockpt()</a></i>,
<i><a href="stdlib.h.html">&lt;stdlib.h&gt;</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
